Greptile Summary

This PR adds a -c/--config CLI flag to aw-server so users can point the server at an arbitrary config file path instead of the default location. When the target file does not exist the server creates it with commented-out defaults, just as it does for the standard path.

• config.rs: create_config gains a config_override: Option<&Path> parameter; a new get_config_path helper resolves either the override or the default testing/production path, and create_dir_all is called on the parent so nested paths are created automatically.
• main.rs: Wires the new --config/-c flag through clap and passes it to create_config via as_deref().
• Tests: Two new tests use a module-local Mutex to serialise access to the shared TESTING global and a Drop-based wrapper for automatic temp-dir cleanup.

Confidence Score: 5/5

Safe to merge — the new --config flag is wired correctly through clap and the config-loading path, and the two new tests are properly serialised against the shared TESTING global.

The core logic change is small and correct: get_config_path delegates to the override when one is present and falls back to the existing testing/production path otherwise. Parent-directory creation is handled uniformly. The only remarks are in the test module (a now-redundant create_dir_all call and a mutex-poisoning edge case on test panic), neither of which affects production behaviour.

No files require special attention.

Important Files Changed

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[aw-server starts] --> B{--config flag provided?}
    B -- Yes --> C[Use override path as-is]
    B -- No --> D{--testing mode?}
    D -- Yes --> E[config-testing.toml in config dir]
    D -- No --> F[config.toml in config dir]
    C --> G[create_dir_all for parent]
    E --> H[create_dir_all for parent]
    F --> H
    G --> I{File exists?}
    H --> I
    I -- No --> J[Write commented-out default config]
    J --> K[Read & parse TOML]
    I -- Yes --> K
    K --> L[Return AWConfig]
    L --> M[Apply CLI overrides: --host, --port, etc.]

_{Reviews (2): Last reviewed commit: "test(server): isolate config override te..." | Re-trigger Greptile}

Codecov Report

❌ Patch coverage is 80.00000% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 76.48%. Comparing base (656f3c9) to head (3c8270b).
⚠️ Report is 51 commits behind head on master.

@@            Coverage Diff             @@
##           master     #601      +/-   ##
==========================================
+ Coverage   70.81%   76.48%   +5.66%     
==========================================
  Files          51       61      +10     
  Lines        2916     4809    +1893     
==========================================
+ Hits         2065     3678    +1613     
- Misses        851     1131     +280     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

CI is green and the Greptile threads are resolved on 3c8270b. I tried to merge this on 2026-05-12, but TimeToBuildBob does not have merge permission on ActivityWatch/aw-server-rust, so this is waiting on a maintainer click.